<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkToolbar</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="prev" href="GtkToolShell.html" title="GtkToolShell">
<link rel="next" href="GtkToolItem.html" title="GtkToolItem">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkToolShell.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
<td><a accesskey="n" href="GtkToolItem.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkToolbar.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#GtkToolbar.description" class="shortcut">Description</a>
                   | 
                  <a href="#GtkToolbar.object-hierarchy" class="shortcut">Object Hierarchy</a>
                   | 
                  <a href="#GtkToolbar.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                   | 
                  <a href="#GtkToolbar.properties" class="shortcut">Properties</a>
                   | 
                  <a href="#GtkToolbar.child-properties" class="shortcut">Child Properties</a>
                   | 
                  <a href="#GtkToolbar.style-properties" class="shortcut">Style Properties</a>
                   | 
                  <a href="#GtkToolbar.signals" class="shortcut">Signals</a>
</td></tr>
</table>
<div class="refentry">
<a name="GtkToolbar"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkToolbar.top_of_page"></a>GtkToolbar</span></h2>
<p>GtkToolbar — Create bars of buttons and other widgets</p>
</td>
<td valign="top" align="right"><img src="toolbar.png"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkToolbar.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="GtkToolbar.html#GtkToolbar-struct" title="struct GtkToolbar">GtkToolbar</a>;
enum                <a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType">GtkToolbarChildType</a>;
enum                <a class="link" href="GtkToolbar.html#GtkToolbarSpaceStyle" title="enum GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</a>;
struct              <a class="link" href="GtkToolbar.html#GtkToolbarChild" title="struct GtkToolbarChild">GtkToolbarChild</a>;
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-new" title="gtk_toolbar_new ()">gtk_toolbar_new</a>                     (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()">gtk_toolbar_insert</a>                  (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkToolbar.html#gtk-toolbar-get-item-index" title="gtk_toolbar_get_item_index ()">gtk_toolbar_get_item_index</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkToolbar.html#gtk-toolbar-get-n-items" title="gtk_toolbar_get_n_items ()">gtk_toolbar_get_n_items</a>             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       <a class="link" href="GtkToolbar.html#gtk-toolbar-get-nth-item" title="gtk_toolbar_get_nth_item ()">gtk_toolbar_get_nth_item</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkToolbar.html#gtk-toolbar-get-drop-index" title="gtk_toolbar_get_drop_index ()">gtk_toolbar_get_drop_index</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-drop-highlight-item" title="gtk_toolbar_set_drop_highlight_item ()">gtk_toolbar_set_drop_highlight_item</a> (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-show-arrow" title="gtk_toolbar_set_show_arrow ()">gtk_toolbar_set_show_arrow</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_arrow</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-orientation" title="gtk_toolbar_set_orientation ()">gtk_toolbar_set_orientation</a>         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-tooltips" title="gtk_toolbar_set_tooltips ()">gtk_toolbar_set_tooltips</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-unset-icon-size" title="gtk_toolbar_unset_icon_size ()">gtk_toolbar_unset_icon_size</a>         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkToolbar.html#gtk-toolbar-get-show-arrow" title="gtk_toolbar_get_show_arrow ()">gtk_toolbar_get_show_arrow</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="returnvalue">GtkOrientation</span></a>      <a class="link" href="GtkToolbar.html#gtk-toolbar-get-orientation" title="gtk_toolbar_get_orientation ()">gtk_toolbar_get_orientation</a>         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="gtk-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="returnvalue">GtkToolbarStyle</span></a>     <a class="link" href="GtkToolbar.html#gtk-toolbar-get-style" title="gtk_toolbar_get_style ()">gtk_toolbar_get_style</a>               (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         <a class="link" href="GtkToolbar.html#gtk-toolbar-get-icon-size" title="gtk_toolbar_get_icon_size ()">gtk_toolbar_get_icon_size</a>           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkToolbar.html#gtk-toolbar-get-tooltips" title="gtk_toolbar_get_tooltips ()">gtk_toolbar_get_tooltips</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>      <a class="link" href="GtkToolbar.html#gtk-toolbar-get-relief-style" title="gtk_toolbar_get_relief_style ()">gtk_toolbar_get_relief_style</a>        (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-append-item" title="gtk_toolbar_append_item ()">gtk_toolbar_append_item</a>             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-prepend-item" title="gtk_toolbar_prepend_item ()">gtk_toolbar_prepend_item</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-insert-item" title="gtk_toolbar_insert_item ()">gtk_toolbar_insert_item</a>             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-append-space" title="gtk_toolbar_append_space ()">gtk_toolbar_append_space</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-prepend-space" title="gtk_toolbar_prepend_space ()">gtk_toolbar_prepend_space</a>           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-insert-space" title="gtk_toolbar_insert_space ()">gtk_toolbar_insert_space</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-append-element" title="gtk_toolbar_append_element ()">gtk_toolbar_append_element</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> type</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-prepend-element" title="gtk_toolbar_prepend_element ()">gtk_toolbar_prepend_element</a>         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> type</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-insert-element" title="gtk_toolbar_insert_element ()">gtk_toolbar_insert_element</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> type</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-append-widget" title="gtk_toolbar_append_widget ()">gtk_toolbar_append_widget</a>           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-prepend-widget" title="gtk_toolbar_prepend_widget ()">gtk_toolbar_prepend_widget</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-insert-widget" title="gtk_toolbar_insert_widget ()">gtk_toolbar_insert_widget</a>           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()">gtk_toolbar_set_style</a>               (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> style</code></em>);
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-insert-stock" title="gtk_toolbar_insert_stock ()">gtk_toolbar_insert_stock</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()">gtk_toolbar_set_icon_size</a>           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-remove-space" title="gtk_toolbar_remove_space ()">gtk_toolbar_remove_space</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-unset-style" title="gtk_toolbar_unset_style ()">gtk_toolbar_unset_style</a>             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="GtkToolbar.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
                           +----GtkToolbar
</pre>
</div>
<div class="refsect1">
<a name="GtkToolbar.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkToolbar implements
 AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>,  <a class="link" href="GtkToolShell.html" title="GtkToolShell">GtkToolShell</a> and  <a class="link" href="gtk-Orientable.html#GtkOrientable">GtkOrientable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkToolbar.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkToolbar.html#GtkToolbar--icon-size" title='The "icon-size" property'>icon-size</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
  "<a class="link" href="GtkToolbar.html#GtkToolbar--icon-size-set" title='The "icon-size-set" property'>icon-size-set</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  "<a class="link" href="GtkToolbar.html#GtkToolbar--show-arrow" title='The "show-arrow" property'>show-arrow</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  "<a class="link" href="GtkToolbar.html#GtkToolbar--toolbar-style" title='The "toolbar-style" property'>toolbar-style</a>"            <a class="link" href="gtk-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a>       : Read / Write
  "<a class="link" href="GtkToolbar.html#GtkToolbar--tooltips" title='The "tooltips" property'>tooltips</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
</pre>
</div>
<div class="refsect1">
<a name="GtkToolbar.child-properties"></a><h2>Child Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkToolbar.html#GtkToolbar--c-expand" title='The "expand" child property'>expand</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  "<a class="link" href="GtkToolbar.html#GtkToolbar--c-homogeneous" title='The "homogeneous" child property'>homogeneous</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
</pre>
</div>
<div class="refsect1">
<a name="GtkToolbar.style-properties"></a><h2>Style Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkToolbar.html#GtkToolbar--s-button-relief" title='The "button-relief" style property'>button-relief</a>"            <a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="type">GtkReliefStyle</span></a>        : Read
  "<a class="link" href="GtkToolbar.html#GtkToolbar--s-internal-padding" title='The "internal-padding" style property'>internal-padding</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
  "<a class="link" href="GtkToolbar.html#GtkToolbar--s-max-child-expand" title='The "max-child-expand" style property'>max-child-expand</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
  "<a class="link" href="GtkToolbar.html#GtkToolbar--s-shadow-type" title='The "shadow-type" style property'>shadow-type</a>"              <a class="link" href="gtk-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a>         : Read
  "<a class="link" href="GtkToolbar.html#GtkToolbar--s-space-size" title='The "space-size" style property'>space-size</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
  "<a class="link" href="GtkToolbar.html#GtkToolbar--s-space-style" title='The "space-style" style property'>space-style</a>"              <a class="link" href="GtkToolbar.html#GtkToolbarSpaceStyle" title="enum GtkToolbarSpaceStyle"><span class="type">GtkToolbarSpaceStyle</span></a>  : Read
</pre>
</div>
<div class="refsect1">
<a name="GtkToolbar.signals"></a><h2>Signals</h2>
<pre class="synopsis">
  "<a class="link" href="GtkToolbar.html#GtkToolbar-focus-home-or-end" title='The "focus-home-or-end" signal'>focus-home-or-end</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
  "<a class="link" href="GtkToolbar.html#GtkToolbar-orientation-changed" title='The "orientation-changed" signal'>orientation-changed</a>"                            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
  "<a class="link" href="GtkToolbar.html#GtkToolbar-popup-context-menu" title='The "popup-context-menu" signal'>popup-context-menu</a>"                             : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  "<a class="link" href="GtkToolbar.html#GtkToolbar-style-changed" title='The "style-changed" signal'>style-changed</a>"                                  : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
</pre>
</div>
<div class="refsect1">
<a name="GtkToolbar.description"></a><h2>Description</h2>
<p>
A toolbar is created with a call to <a class="link" href="GtkToolbar.html#gtk-toolbar-new" title="gtk_toolbar_new ()"><code class="function">gtk_toolbar_new()</code></a>.
</p>
<p>
A toolbar can contain instances of a subclass of <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>. To add
a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> to the a toolbar, use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a>. To remove
an item from the toolbar use <a class="link" href="GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()"><code class="function">gtk_container_remove()</code></a>. To add a button
to the toolbar, add an instance of <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>.
</p>
<p>
Toolbar items can be visually grouped by adding instances of
<a class="link" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a> to the toolbar. If a <a class="link" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a> has
the "expand" property set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> and the "draw" property set to
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> the effect is to force all following items to the end of the
toolbar.
</p>
<p>
Creating a context menu for the toolbar can be done by connecting to
the <a class="link" href="GtkToolbar.html#GtkToolbar-popup-context-menu" title='The "popup-context-menu" signal'><span class="type">"popup-context-menu"</span></a> signal.
</p>
</div>
<div class="refsect1">
<a name="GtkToolbar.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkToolbar-struct"></a><h3>struct GtkToolbar</h3>
<pre class="programlisting">struct GtkToolbar {
  gint             GSEAL (num_children);
  GList           *GSEAL (children);
  GtkOrientation   GSEAL (orientation);
  GtkToolbarStyle  GSEAL (style);
  GtkIconSize      GSEAL (icon_size);

#ifndef GTK_DISABLE_DEPRECATED
  GtkTooltips     *GSEAL (tooltips);
#else
  gpointer         GSEAL (_tooltips);
#endif
};
</pre>
<p>
The <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> struct only contains private data and should only be
accessed through the function described below.
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbarChildType"></a><h3>enum GtkToolbarChildType</h3>
<pre class="programlisting">typedef enum {
  GTK_TOOLBAR_CHILD_SPACE,
  GTK_TOOLBAR_CHILD_BUTTON,
  GTK_TOOLBAR_CHILD_TOGGLEBUTTON,
  GTK_TOOLBAR_CHILD_RADIOBUTTON,
  GTK_TOOLBAR_CHILD_WIDGET
} GtkToolbarChildType;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkToolbarChildType</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
<a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> is used to set the type of new elements that are added
to a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><a name="GTK-TOOLBAR-CHILD-SPACE:CAPS"></a><span class="term"><code class="literal">GTK_TOOLBAR_CHILD_SPACE</code></span></p></td>
<td>a space in the style of the toolbar's <a class="link" href="GtkToolbar.html#GtkToolbarSpaceStyle" title="enum GtkToolbarSpaceStyle"><span class="type">GtkToolbarSpaceStyle</span></a>.
</td>
</tr>
<tr>
<td><p><a name="GTK-TOOLBAR-CHILD-BUTTON:CAPS"></a><span class="term"><code class="literal">GTK_TOOLBAR_CHILD_BUTTON</code></span></p></td>
<td>a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>.
</td>
</tr>
<tr>
<td><p><a name="GTK-TOOLBAR-CHILD-TOGGLEBUTTON:CAPS"></a><span class="term"><code class="literal">GTK_TOOLBAR_CHILD_TOGGLEBUTTON</code></span></p></td>
<td>a <a class="link" href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</span></a>.
</td>
</tr>
<tr>
<td><p><a name="GTK-TOOLBAR-CHILD-RADIOBUTTON:CAPS"></a><span class="term"><code class="literal">GTK_TOOLBAR_CHILD_RADIOBUTTON</code></span></p></td>
<td>a <a class="link" href="GtkRadioButton.html" title="GtkRadioButton"><span class="type">GtkRadioButton</span></a>.
</td>
</tr>
<tr>
<td><p><a name="GTK-TOOLBAR-CHILD-WIDGET:CAPS"></a><span class="term"><code class="literal">GTK_TOOLBAR_CHILD_WIDGET</code></span></p></td>
<td>a standard <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbarSpaceStyle"></a><h3>enum GtkToolbarSpaceStyle</h3>
<pre class="programlisting">typedef enum {
  GTK_TOOLBAR_SPACE_EMPTY,
  GTK_TOOLBAR_SPACE_LINE
} GtkToolbarSpaceStyle;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbarChild"></a><h3>struct GtkToolbarChild</h3>
<pre class="programlisting">struct GtkToolbarChild {
  GtkToolbarChildType type;
  GtkWidget *widget;
  GtkWidget *icon;
  GtkWidget *label;
};
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkToolbarChild</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-new"></a><h3>gtk_toolbar_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_new                     (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Creates a new toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the newly-created toolbar.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-insert"></a><h3>gtk_toolbar_insert ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_insert                  (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>);</pre>
<p>
Insert a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> into the toolbar at position <em class="parameter"><code>pos</code></em>. If <em class="parameter"><code>pos</code></em> is
0 the item is prepended to the start of the toolbar. If <em class="parameter"><code>pos</code></em> is
negative, the item is appended to the end of the toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
<td>the position of the new item</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-item-index"></a><h3>gtk_toolbar_get_item_index ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_item_index          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>);</pre>
<p>
Returns the position of <em class="parameter"><code>item</code></em> on the toolbar, starting from 0.
It is an error if <em class="parameter"><code>item</code></em> is not a child of the toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> that is a child of <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the position of item on the toolbar.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-n-items"></a><h3>gtk_toolbar_get_n_items ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_n_items             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Returns the number of items on the toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the number of items on the toolbar</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-nth-item"></a><h3>gtk_toolbar_get_nth_item ()</h3>
<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       gtk_toolbar_get_nth_item            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);</pre>
<p>
Returns the <em class="parameter"><code>n</code></em>'th item on <em class="parameter"><code>toolbar</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the
toolbar does not contain an <em class="parameter"><code>n</code></em>'th item.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
<td>A position on the toolbar</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The <em class="parameter"><code>n</code></em>'th <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> on <em class="parameter"><code>toolbar</code></em>,
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there isn't an <em class="parameter"><code>n</code></em>'th item. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-drop-index"></a><h3>gtk_toolbar_get_drop_index ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_drop_index          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
<p>
Returns the position corresponding to the indicated point on
<em class="parameter"><code>toolbar</code></em>. This is useful when dragging items to the toolbar:
this function returns the position a new item should be
inserted.
</p>
<p>
<em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> are in <em class="parameter"><code>toolbar</code></em> coordinates.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
<td>x coordinate of a point on the toolbar</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
<td>y coordinate of a point on the toolbar</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The position corresponding to the point (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>) on the toolbar.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-drop-highlight-item"></a><h3>gtk_toolbar_set_drop_highlight_item ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_drop_highlight_item (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>);</pre>
<p>
Highlights <em class="parameter"><code>toolbar</code></em> to give an idea of what it would look like
if <em class="parameter"><code>item</code></em> was added to <em class="parameter"><code>toolbar</code></em> at the position indicated by <em class="parameter"><code>index_</code></em>.
If <em class="parameter"><code>item</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, highlighting is turned off. In that case <em class="parameter"><code>index_</code></em> 
is ignored.
</p>
<p>
The <em class="parameter"><code>tool_item</code></em> passed to this function must not be part of any widget
hierarchy. When an item is set as drop highlight item it can not
added to any widget hierarchy or used as highlight item for another
toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to turn of highlighting. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
<td>a position on <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-show-arrow"></a><h3>gtk_toolbar_set_show_arrow ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_show_arrow          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_arrow</code></em>);</pre>
<p>
Sets whether to show an overflow menu when
<em class="parameter"><code>toolbar</code></em> doesn't have room for all items on it. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>,
items that there are not room are available through an
overflow menu.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>show_arrow</code></em> :</span></p></td>
<td>Whether to show an overflow menu</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-orientation"></a><h3>gtk_toolbar_set_orientation ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_orientation         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_set_orientation</code> has been deprecated since version 2.16 and should not be used in newly-written code. Use <a class="link" href="gtk-Orientable.html#gtk-orientable-set-orientation" title="gtk_orientable_set_orientation ()"><code class="function">gtk_orientable_set_orientation()</code></a> instead.</p>
</div>
<p>
Sets whether a toolbar should appear horizontally or vertically.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>orientation</code></em> :</span></p></td>
<td>a new <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-tooltips"></a><h3>gtk_toolbar_set_tooltips ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_tooltips            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_set_tooltips</code> has been deprecated since version 2.14 and should not be used in newly-written code. The toolkit-wide <a class="link" href="GtkSettings.html#GtkSettings--gtk-enable-tooltips" title='The "gtk-enable-tooltips" property'><span class="type">"gtk-enable-tooltips"</span></a> property
is now used instead.</p>
</div>
<p>
Sets if the tooltips of a toolbar should be active or not.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>enable</code></em> :</span></p></td>
<td>set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to disable the tooltips, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to enable them.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-unset-icon-size"></a><h3>gtk_toolbar_unset_icon_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_unset_icon_size         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Unsets toolbar icon size set with <a class="link" href="GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()"><code class="function">gtk_toolbar_set_icon_size()</code></a>, so that
user preferences will be used to determine the icon size.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-show-arrow"></a><h3>gtk_toolbar_get_show_arrow ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_toolbar_get_show_arrow          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Returns whether the toolbar has an overflow menu.
See <a class="link" href="GtkToolbar.html#gtk-toolbar-set-show-arrow" title="gtk_toolbar_set_show_arrow ()"><code class="function">gtk_toolbar_set_show_arrow()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the toolbar has an overflow menu.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-orientation"></a><h3>gtk_toolbar_get_orientation ()</h3>
<pre class="programlisting"><a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="returnvalue">GtkOrientation</span></a>      gtk_toolbar_get_orientation         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_get_orientation</code> has been deprecated since version 2.16 and should not be used in newly-written code. Use <a class="link" href="gtk-Orientable.html#gtk-orientable-get-orientation" title="gtk_orientable_get_orientation ()"><code class="function">gtk_orientable_get_orientation()</code></a> instead.</p>
</div>
<p>
Retrieves the current orientation of the toolbar. See
<a class="link" href="GtkToolbar.html#gtk-toolbar-set-orientation" title="gtk_toolbar_set_orientation ()"><code class="function">gtk_toolbar_set_orientation()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the orientation</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-style"></a><h3>gtk_toolbar_get_style ()</h3>
<pre class="programlisting"><a class="link" href="gtk-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="returnvalue">GtkToolbarStyle</span></a>     gtk_toolbar_get_style               (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Retrieves whether the toolbar has text, icons, or both . See
<a class="link" href="GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()"><code class="function">gtk_toolbar_set_style()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the current style of <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-icon-size"></a><h3>gtk_toolbar_get_icon_size ()</h3>
<pre class="programlisting"><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         gtk_toolbar_get_icon_size           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Retrieves the icon size for the toolbar. See <a class="link" href="GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()"><code class="function">gtk_toolbar_set_icon_size()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the current icon size for the icons on
the toolbar. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> int]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-tooltips"></a><h3>gtk_toolbar_get_tooltips ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_toolbar_get_tooltips            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_get_tooltips</code> has been deprecated since version 2.14 and should not be used in newly-written code. The toolkit-wide <a class="link" href="GtkSettings.html#GtkSettings--gtk-enable-tooltips" title='The "gtk-enable-tooltips" property'><span class="type">"gtk-enable-tooltips"</span></a> property
is now used instead.</p>
</div>
<p>
Retrieves whether tooltips are enabled. See
<a class="link" href="GtkToolbar.html#gtk-toolbar-set-tooltips" title="gtk_toolbar_set_tooltips ()"><code class="function">gtk_toolbar_set_tooltips()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if tooltips are enabled</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-get-relief-style"></a><h3>gtk_toolbar_get_relief_style ()</h3>
<pre class="programlisting"><a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>      gtk_toolbar_get_relief_style        (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Returns the relief style of buttons on <em class="parameter"><code>toolbar</code></em>. See
<a class="link" href="GtkButton.html#gtk-button-set-relief" title="gtk_button_set_relief ()"><code class="function">gtk_button_set_relief()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The relief style of buttons on <em class="parameter"><code>toolbar</code></em>.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-append-item"></a><h3>gtk_toolbar_append_item ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_append_item             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_append_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Inserts a new item into the toolbar. You must specify the position
in the toolbar where it will be inserted.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS"><code class="function">G_CALLBACK()</code></a> to cast the function to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>give your toolbar button a label.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>a string that appears when the user holds the mouse over this item.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>use with <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that should be used as the button's icon.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>the function to be executed when the button is pressed.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>a pointer to any data you wish to be passed to the callback.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the new toolbar item as a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-prepend-item"></a><h3>gtk_toolbar_prepend_item ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_prepend_item            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_prepend_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Adds a new button to the beginning (top or left edges) of the given toolbar.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS"><code class="function">G_CALLBACK()</code></a> to cast the function to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>give your toolbar button a label.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>a string that appears when the user holds the mouse over this item.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>use with <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that should be used as the button's icon.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>the function to be executed when the button is pressed.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>a pointer to any data you wish to be passed to the callback.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the new toolbar item as a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-insert-item"></a><h3>gtk_toolbar_insert_item ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_insert_item             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Inserts a new item into the toolbar. You must specify the position in the
toolbar where it will be inserted.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS"><code class="function">G_CALLBACK()</code></a> to cast the function to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>give your toolbar button a label.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>a string that appears when the user holds the mouse over this item.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>use with <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that should be used as the button's icon.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>the function to be executed when the button is pressed.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>a pointer to any data you wish to be passed to the callback.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the number of widgets to insert this item after.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the new toolbar item as a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-append-space"></a><h3>gtk_toolbar_append_space ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_append_space            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_append_space</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Adds a new space to the end of the toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-prepend-space"></a><h3>gtk_toolbar_prepend_space ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_prepend_space           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_prepend_space</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Adds a new space to the beginning of the toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-insert-space"></a><h3>gtk_toolbar_insert_space ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_insert_space            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_space</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Inserts a new space in the toolbar at the specified position.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the number of widgets after which a space should be inserted.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-append-element"></a><h3>gtk_toolbar_append_element ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_append_element          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> type</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_append_element</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Adds a new element to the end of a toolbar.
</p>
<p>
If <em class="parameter"><code>type</code></em> == <a class="link" href="GtkToolbar.html#GTK-TOOLBAR-CHILD-WIDGET:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_WIDGET</code></a>, <em class="parameter"><code>widget</code></em> is used as the new element.
If <em class="parameter"><code>type</code></em> == <a class="link" href="GtkToolbar.html#GTK-TOOLBAR-CHILD-RADIOBUTTON:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_RADIOBUTTON</code></a>, <em class="parameter"><code>widget</code></em> is used to determine
the radio group for the new element. In all other cases, <em class="parameter"><code>widget</code></em> must
be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS"><code class="function">G_CALLBACK()</code></a> to cast the function to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>.
</p>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
<td>a value of type <a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> that determines what <em class="parameter"><code>widget</code></em> will be.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the element's label.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>the element's tooltip.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>used for context-sensitive help about this toolbar element.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that provides pictorial representation of the element's function.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>the function to be executed when the button is pressed.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>any data you wish to pass to the callback.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the new toolbar element as a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-prepend-element"></a><h3>gtk_toolbar_prepend_element ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_prepend_element         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> type</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_prepend_element</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Adds a new element to the beginning of a toolbar.
</p>
<p>
If <em class="parameter"><code>type</code></em> == <a class="link" href="GtkToolbar.html#GTK-TOOLBAR-CHILD-WIDGET:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_WIDGET</code></a>, <em class="parameter"><code>widget</code></em> is used as the new element.
If <em class="parameter"><code>type</code></em> == <a class="link" href="GtkToolbar.html#GTK-TOOLBAR-CHILD-RADIOBUTTON:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_RADIOBUTTON</code></a>, <em class="parameter"><code>widget</code></em> is used to determine
the radio group for the new element. In all other cases, <em class="parameter"><code>widget</code></em> must
be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS"><code class="function">G_CALLBACK()</code></a> to cast the function to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
<td>a value of type <a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> that determines what <em class="parameter"><code>widget</code></em> will be.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the element's label.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>the element's tooltip.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>used for context-sensitive help about this toolbar element.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that provides pictorial representation of the element's function.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>the function to be executed when the button is pressed.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>any data you wish to pass to the callback.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the new toolbar element as a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-insert-element"></a><h3>gtk_toolbar_insert_element ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_insert_element          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> type</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_element</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Inserts a new element in the toolbar at the given position. 
</p>
<p>
If <em class="parameter"><code>type</code></em> == <a class="link" href="GtkToolbar.html#GTK-TOOLBAR-CHILD-WIDGET:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_WIDGET</code></a>, <em class="parameter"><code>widget</code></em> is used as the new element.
If <em class="parameter"><code>type</code></em> == <a class="link" href="GtkToolbar.html#GTK-TOOLBAR-CHILD-RADIOBUTTON:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_RADIOBUTTON</code></a>, <em class="parameter"><code>widget</code></em> is used to determine
the radio group for the new element. In all other cases, <em class="parameter"><code>widget</code></em> must
be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS"><code class="function">G_CALLBACK()</code></a> to cast the function to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
<td>a value of type <a class="link" href="GtkToolbar.html#GtkToolbarChildType" title="enum GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> that determines what <em class="parameter"><code>widget</code></em>
will be.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>the element's label.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>the element's tooltip.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>used for context-sensitive help about this toolbar element.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that provides pictorial representation of the element's function.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>the function to be executed when the button is pressed.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>any data you wish to pass to the callback.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the number of widgets to insert this element after.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the new toolbar element as a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-append-widget"></a><h3>gtk_toolbar_append_widget ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_append_widget           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_append_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Adds a widget to the end of the given toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to add to the toolbar.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>the element's tooltip. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>used for context-sensitive help about this toolbar element. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-prepend-widget"></a><h3>gtk_toolbar_prepend_widget ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_prepend_widget          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_prepend_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Adds a widget to the beginning of the given toolbar.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to add to the toolbar.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>the element's tooltip. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>used for context-sensitive help about this toolbar element. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-insert-widget"></a><h3>gtk_toolbar_insert_widget ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_insert_widget           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Inserts a widget in the toolbar at the given position.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to add to the toolbar.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>the element's tooltip. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>used for context-sensitive help about this toolbar element. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the number of widgets to insert this widget after.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-style"></a><h3>gtk_toolbar_set_style ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_style               (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> style</code></em>);</pre>
<p>
Alters the view of <em class="parameter"><code>toolbar</code></em> to display either icons only, text only, or both.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
<td>the new style for <em class="parameter"><code>toolbar</code></em>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-insert-stock"></a><h3>gtk_toolbar_insert_stock ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_insert_stock            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_text</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *tooltip_private_text</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_stock</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Inserts a stock item at the specified position of the toolbar.  If
<em class="parameter"><code>stock_id</code></em> is not a known stock item ID, it's inserted verbatim,
except that underscores used to mark mnemonics are removed.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS"><code class="function">G_CALLBACK()</code></a> to cast the function to <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>A <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></p></td>
<td>The id of the stock item you want to insert</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></p></td>
<td>The text in the tooltip of the toolbar button</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></p></td>
<td>The private text of the tooltip</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>The callback called when the toolbar button is clicked.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data passed to callback</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>The position the button shall be inserted at.
-1 means at the end.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the inserted widget</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-set-icon-size"></a><h3>gtk_toolbar_set_icon_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_icon_size           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);</pre>
<p>
This function sets the size of stock icons in the toolbar. You
can call it both before you add the icons and after they've been
added. The size you set will override user preferences for the default
icon size.
</p>
<p>
This should only be used for special-purpose toolbars, normal
application toolbars should respect the user preferences for the
size of icons.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>A <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon_size</code></em> :</span></p></td>
<td>The <a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> that stock icons in the
toolbar shall have. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> int]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-remove-space"></a><h3>gtk_toolbar_remove_space ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_remove_space            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_remove_space</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a> instead.</p>
</div>
<p>
Removes a space from the specified position.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the index of the space to remove.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-toolbar-unset-style"></a><h3>gtk_toolbar_unset_style ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_unset_style             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
<p>
Unsets a toolbar style set with <a class="link" href="GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()"><code class="function">gtk_toolbar_set_style()</code></a>, so that
user preferences will be used to determine the toolbar style.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1">
<a name="GtkToolbar.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkToolbar--icon-size"></a><h3>The <code class="literal">"icon-size"</code> property</h3>
<pre class="programlisting">  "icon-size"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
<p>
The size of the icons in a toolbar is normally determined by
the toolbar-icon-size setting. When this property is set, it
overrides the setting. 
</p>
<p>
This should only be used for special-purpose toolbars, normal
application toolbars should respect the user preferences for the
size of icons.
</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 3</p>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--icon-size-set"></a><h3>The <code class="literal">"icon-size-set"</code> property</h3>
<pre class="programlisting">  "icon-size-set"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>
Is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon-size property has been set.
</p>
<p>Default value: FALSE</p>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--show-arrow"></a><h3>The <code class="literal">"show-arrow"</code> property</h3>
<pre class="programlisting">  "show-arrow"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>If an arrow should be shown if the toolbar doesn't fit.</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--toolbar-style"></a><h3>The <code class="literal">"toolbar-style"</code> property</h3>
<pre class="programlisting">  "toolbar-style"            <a class="link" href="gtk-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a>       : Read / Write</pre>
<p>How to draw the toolbar.</p>
<p>Default value: GTK_TOOLBAR_BOTH</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--tooltips"></a><h3>The <code class="literal">"tooltips"</code> property</h3>
<pre class="programlisting">  "tooltips"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>
If the tooltips of the toolbar should be active or not.
</p>
<p>Default value: TRUE</p>
<p class="since">Since 2.8</p>
</div>
</div>
<div class="refsect1">
<a name="GtkToolbar.child-property-details"></a><h2>Child Property Details</h2>
<div class="refsect2">
<a name="GtkToolbar--c-expand"></a><h3>The <code class="literal">"expand"</code> child property</h3>
<pre class="programlisting">  "expand"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>Whether the item should receive extra space when the toolbar grows.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--c-homogeneous"></a><h3>The <code class="literal">"homogeneous"</code> child property</h3>
<pre class="programlisting">  "homogeneous"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>Whether the item should be the same size as other homogeneous items.</p>
<p>Default value: FALSE</p>
</div>
</div>
<div class="refsect1">
<a name="GtkToolbar.style-property-details"></a><h2>Style Property Details</h2>
<div class="refsect2">
<a name="GtkToolbar--s-button-relief"></a><h3>The <code class="literal">"button-relief"</code> style property</h3>
<pre class="programlisting">  "button-relief"            <a class="link" href="gtk-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="type">GtkReliefStyle</span></a>        : Read</pre>
<p>Type of bevel around toolbar buttons.</p>
<p>Default value: GTK_RELIEF_NONE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--s-internal-padding"></a><h3>The <code class="literal">"internal-padding"</code> style property</h3>
<pre class="programlisting">  "internal-padding"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
<p>Amount of border space between the toolbar shadow and the buttons.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--s-max-child-expand"></a><h3>The <code class="literal">"max-child-expand"</code> style property</h3>
<pre class="programlisting">  "max-child-expand"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
<p>Maximum amount of space an expandable item will be given.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 2147483647</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--s-shadow-type"></a><h3>The <code class="literal">"shadow-type"</code> style property</h3>
<pre class="programlisting">  "shadow-type"              <a class="link" href="gtk-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a>         : Read</pre>
<p>Style of bevel around the toolbar.</p>
<p>Default value: GTK_SHADOW_OUT</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--s-space-size"></a><h3>The <code class="literal">"space-size"</code> style property</h3>
<pre class="programlisting">  "space-size"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
<p>Size of spacers.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 12</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar--s-space-style"></a><h3>The <code class="literal">"space-style"</code> style property</h3>
<pre class="programlisting">  "space-style"              <a class="link" href="GtkToolbar.html#GtkToolbarSpaceStyle" title="enum GtkToolbarSpaceStyle"><span class="type">GtkToolbarSpaceStyle</span></a>  : Read</pre>
<p>Whether spacers are vertical lines or just blank.</p>
<p>Default value: GTK_TOOLBAR_SPACE_LINE</p>
</div>
</div>
<div class="refsect1">
<a name="GtkToolbar.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkToolbar-focus-home-or-end"></a><h3>The <code class="literal">"focus-home-or-end"</code> signal</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>    focus_home,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)       : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
<p>
A keybinding signal used internally by GTK+. This signal can't
be used in application code
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>the <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>focus_home</code></em> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the first item should be focused</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the signal was handled, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar-orientation-changed"></a><h3>The <code class="literal">"orientation-changed"</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>    *toolbar,
                                                        <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)        : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
<p>
Emitted when the orientation of the toolbar changes.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>the object which emitted the signal</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>orientation</code></em> :</span></p></td>
<td>the new <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> of the toolbar</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar-popup-context-menu"></a><h3>The <code class="literal">"popup-context-menu"</code> signal</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>        x,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>        y,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>        button,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
<p>
Emitted when the user right-clicks the toolbar or uses the
keybinding to display a popup menu.
</p>
<p>
Application developers should handle this signal if they want
to display a context menu on the toolbar. The context-menu should
appear at the coordinates given by <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em>. The mouse button
number is given by the <em class="parameter"><code>button</code></em> parameter. If the menu was popped
up using the keybaord, <em class="parameter"><code>button</code></em> is -1.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>the <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
<td>the x coordinate of the point where the menu should appear</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
<td>the y coordinate of the point where the menu should appear</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
<td>the mouse button the user pressed, or -1</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the signal was handled, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GtkToolbar-style-changed"></a><h3>The <code class="literal">"style-changed"</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>     *toolbar,
                                                        <a class="link" href="gtk-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> style,
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
<p>
Emitted when the style of the toolbar changes.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
<td>The <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
<td>the new <a class="link" href="gtk-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> of the toolbar</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1">
<a name="GtkToolbar.see-also"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></span></p></td>
<td><p>Base class of widgets that can be added to a toolbar.</p></td>
</tr></tbody>
</table></div>
<p>
</p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>